Wskazówki dotyczące rozwiązywania problemów z łączem i przyciskiem płatności w systemie PayPal
Otrzymuję komunikat o błędzie, a przycisk nie jest wyświetlany w mojej witrynie.
- Sprawdź, czy Twoje połączenie internetowe działa.
- Odwiedź inne strony na swojej witrynie i sprawdź, czy ładują się prawidłowo.
- Przejdź do strony Przyciski PayPal i sprawdź:
- Czy przycisk jest wyświetlany w sekcji „Zapisane przyciski”?
- Wybierz „Edytuj” i upewnij się, że kod przycisku jest taki sam, jak w Twojej witrynie
- . Kliknij prawym przyciskiem myszy stronę produktu (na której został umieszczony kod przycisku) i kliknij „Sprawdź”. Przejdź do karty Konsola (wyświetlanej u góry strony). Mogą pojawić się błędy nagłówka CSP.
Jeśli masz wdrożone zasady bezpieczeństwa treści, może dojść do wyświetlania błędów CSP, na przykład: (przykładowe błędy CSP):
- Odmowa załadowania skryptu „https://www.paypal.com/sdk/js**”, ponieważ narusza on następującą dyrektywę zasad bezpieczeństwa treści: „default-src 'self'”. Skrypt „script-src-elem” nie został wyraźnie ustawiony, więc jako alternatywy używa się skryptu „default-src”.
- Odmowa nawiązania połączenia z witryną „https://www.paypal.com/**”, ponieważ narusza ona następującą dyrektywę zasad bezpieczeństwa treści: „default-src 'self'”. Skrypt „connect-src” nie został wyraźnie ustawiony, więc jako alternatywy używa się skryptu „default-src”.
- Odmowa wykonania skryptu wbudowanego, ponieważ narusza on następującą dyrektywę zasad bezpieczeństwa treści: „script-src https://*.paypal.com". Potrzebne jest słowo kluczowe „unsafe-inline”, hash („sha256-WYDWDPwB8j2VePYrqy38aHPcJLsasO//lnXymmxscUk=”), lub funkcja nonce („nonce-...”) do włączenia wykonywania wbudowanego skryptu.
- Odmowa załadowania obrazu „https://tracking.qa.paypal.com/webapps/tracking/ts?**”, ponieważ narusza on następującą dyrektywę zasad bezpieczeństwa treści: „default-src 'self'”. Skrypt „img-src” nie został wyraźnie ustawiony, więc jako alternatywy używa się skryptu „default-src”.
- Odmowa ustawienia ramki „https://www.paypal.com/”, ponieważ narusza ona następującą dyrektywę zasad bezpieczeństwa treści: ”default-src 'self'”. Skrypt „frame-src” nie został wyraźnie ustawiony, więc jako alternatywy używa się skryptu „default-src”.
Możesz spróbować dodać poniższą treść, aby rozwiązać dowolny z powyższych błędów:
Opcja-1 (HTML): Jeśli w pliku HTML skonfigurowano nagłówek CSP, należy użyć poniższego kodu, aby zastąpić kod CSP
<meta http-equiv="Content-Security-Policy" content="default-src 'self';
script-src 'unsafe-inline' https://*.paypal.com https://*.paypalobjects.com;
style-src 'unsafe-inline' https://*.paypal.com; connect-src
https://*.paypal.com; frame-src https://*.paypal.com; img-src
https://*.paypal.com https://*.paypalobjects.com">
Opcja 2 (strona serwera). Jeśli dostawca CSP jest skonfigurowany po stronie serwera, użyj poniższego kodu, aby zastąpić kod
zasad bezpieczeństwa treści (CSP): script-src 'unsafe-inline' https://*.PayPal.com https://*.paypalobjects.com
CSP: style-src 'unsafe-inline' https://*.PayPal.com
CSPy: connect-src https://*.PayPal.com
CSP: frame-src https://*.PayPal.com
CSP: img-src https://*.PayPal.com https://*. paypalobjects.com
Jak zmienić układ/rozmiar/kolor nazwy/ceny/ilości produktu?
Aby zmienić układ/rozmiar/kolor nazwy/ceny/ilości produktu w witrynie PayPal:
- Przejdź do strony Przyciski PayPal.
- Kliknij przycisk Otwórz obok zapisanego przycisku i wybierz opcję Edytuj.
- Kliknij Dostosuj przyciski i wprowadź niezbędne zmiany.
Czy po edycji informacji o produkcie (nazwa, kwota lub cokolwiek innego) potrzebuję
ponownie skopiować/wkleić kod przycisku?
Nie, pobieramy wszystkie informacje z serwera PayPal. Po zapisaniu zmian na koncie nie ma potrzeby aktualizowania kodu przycisku kopiowania/wklejania witryny.
Uwaga: jeśli zmienisz kod waluty na swoim produkcie, należy zaktualizować przycisk płatności.
Widzę identyfikator klienta w kodzie – co on oznacza?
Identyfikator klienta to identyfikator klienta handlowca, który jest częścią Twojego konta. Nie należy go edytować. Należy z niego korzystać w takiej formie, jaka znajduje się w kodzie przycisku.
Pomimo dodania wielu przycisków, żaden z nich nie jest wyświetlany na mojej stronie internetowej.
Szereg przycisków na tej samej stronie internetowej nie będzie działać w następujących scenariuszach:
- Jeśli wielokrotnie skopiowano/wklejono ten sam identyfikator przycisku na tej samej stronie internetowej, pojawi się tylko pierwszy przycisk. Nie można wielokrotnie powtarzać tego samego identyfikatora przycisku.
- Jeśli skopiowano/wklejono różne identyfikatory przycisków, ale w innych walutach na tej samej stronie internetowej, pojawi się tylko pierwszy przycisk. Nie można dodawać walut obcych do przycisków na tej samej stronie internetowej.
- Jeśli skopiowano/wklejono różne identyfikatory przycisków, co doprowadziło do spowolnienia, należy upewnić się, że tag skryptu z identyfikatorem klienta został dodany tylko raz. Wiersz skryptu będzie wyglądał następująco:
<skrypt src="https://www.paypal.com/sdk/js?client-id=XYZ&components=hosted-buttons&enable-funding=venmo¤cy=USD"></script>
Mam konto Premier PayPal i nie widzę łączy i przycisków płatności jako
opcji
.Ta funkcja jest dostępna tylko na kontach firmowych PayPal. Aby korzystać z tej funkcji, należy rozszerzyć konto do konta firmowego lub je utworzyć.
Jak przetestować personalizację w centrum testowym PayPal?
Łącza i przyciski do płatności można przetestować w Centrum testowym.
Wbudowane rozszerzenie inline transakcji kredytowej/debetowej nie wyświetla się w całości w mojej
witrynie.
Upewnij się, że szerokość i wysokość kontenera nadrzędnego są ustawione tak, aby uwzględnić rozszerzenie inline. Aby uzyskać więcej informacji, zapoznaj się z dokumentacją / pomocą techniczną platformy hostingowej.
Czy łącze do płatności i przyciski obsługują BPP (Błyskawiczne powiadamianie o płatności)?
Tak. Wykonaj poniższe czynności, aby skonfigurować i włączyć błyskawiczne powiadamianie o płatności.
Aby odszukać konfigurację błyskawicznego powiadamiania o płatności w systemie PayPal:
- Przejdź do Ustawień konta.
- Wybierz opcję Powiadomienia i Błyskawiczne powiadamianie o płatności.
- Kliknij Aktualizuj łącze.
Aby włączyć Ustawienia BPP:
- Dodaj adres URL obsługujący BPP i wybierz opcję Odbieraj komunikaty BPP (włączone).
- Kliknij Zapisz.
Obsługuj BPP w kodzie swojego serwera:
- Po wybraniu łącza płatności i przycisku transakcji usługa BPP w systemie PayPal wywołuje adres URL powiadomienia skonfigurowany w kroku 2.
Dostęp do historii BPP:
- https://www.sandbox.paypal.com/merchantnotification/ipn/history
- https://www.paypal.com/merchantnotification/ipn/history
Materiały referencyjne
Wstęp: https://developer.paypal.com/api/nvp-soap/ipn/IPNIntro/
Należy użyć prawidłowego adresu URL usługi BPP w kodzie serwera
Przykłady dla innych języków GitHub – paypal/ipn-code-samples
Jakie informacje o zakupie
przesyła firma PayPal po skierowaniu klienta na stronę przekierowania? Czy łącza do płatności i przyciski obsługują przesyłanie danych na temat płatności?
Jakie zmienne są obsługiwane?
Tak, obsługujemy zmienne przesyłanie danych na temat płatności (PDT) zgodnie z opisem tutaj. Otrzymasz PDT, jeśli włączysz ustawienie Automatyczny powrót podczas konfigurowania łącza do płatności i przycisku.
Czy łącza i przyciski do płatności obsługują ustawienia regionalne, jeśli zostały dodane ręcznie przez
handlowca w kodzie przycisku lub łączu do płatności?
Domyślnie łącza i przyciski płatności korzystają z preferencji przeglądarki klientów do wyświetlania kodu przycisku i środowiska łącza do płatności.
Handlowcy mogą nadpisać te ustawienia tylko w przypadku łącza do płatności i kodu przycisku, dodając „locale.x=fr_FR” jako parametr zapytania. Listę obsługiwanych kodów dla ustawień krajowych można znaleźć tutaj. Żaden tekst wprowadzony przez handlowca podczas konfiguracji nie zostanie przetłumaczony.
Przykład: https://www.paypal.com/ncp/payment/F3YMU2ZGT49XX?locale.x=jp_JP
Przykład:
<script src="……¤cy=USD&locale.x=jp_JP"></script>
Czy można ukryć niektóre etykiety, które pochodzą z płatnych linków oraz
kod przycisku?
Rozumiemy, że możesz mieć inną konfigurację wizualną w swojej witrynie, nie zalecamy jednak ukrywania podanego przez nas kodu przycisku.
Ukrycie go przed witryną nie zmieni sposobu przetwarzania transakcji. Transakcja nadal będzie korzystać z konfiguracji identyfikatora przycisku hostowanego.
Można ukryć określony lub cały tekst wokół przycisków, o ile używa się typu przycisku, który nie wymaga wprowadzania danych przez klienta. Na przykład, jeśli klient musi użyć listy wyboru ilości lub wielu pozycji, a te elementy wejściowe zostały ukryte, transakcja zakończy się niepowodzeniem.
Oto przykład sposobu ukrycia ceny przedmiotu:
Dodaj ten skrypt poniżej kodu przycisku, zastąp identyfikator HostedButton_ID rzeczywistym identyfikatorem przycisku.
<style> #paypal-container-<HostedButton_ID> {
#paypal-form-fields-container-<HostedButton_ID> {
#price-label {
display: none !important;
}
}
}
</style>
-
desc-label (dla nazwy produktu) -
price-label (dla ceny)
style> #paypal-container-
<style>
#paypal-container-<HostedButton_ID>
{
#paypal-form-fields-container-<HostedButton_ID>
{
display: none !important;
}
}
</style>
Czy można zastąpić moje łącza do płatności i przyciski, aby korzystać z wysyłki w
Ustawieniach?
Łącza i przyciski do płatności nie będą uwzględniać zbiorczego zastąpienia wysyłki w ustawieniach konta, znanego również jako poniższe ustawienie w Ustawieniach wysyłki.
Waluta przycisku została zmieniona, ale nie jest wyświetlana jako zaktualizowana w
witrynie.
Jeśli zmienisz walutę przycisku już po wklejeniu go na Twojej witrynie, musisz ponownie skopiować/wkleić kod przycisku w swojej witrynie.
Nie mogę wybrać opcji „Użyj wysyłki z Ustawień” i „Użyj podatku z
Ustawień” po wybraniu opcji „Nie pobieraj adresu wysyłkowego”.
Wysyłka i podatek obecne w Ustawieniach zależą od kraju i/lub kodu pocztowego wysyłki klienta. Jeśli wybierzesz opcję „Nie pobieraj adresu wysyłkowego”, nie otrzymasz z Ustawień adresu wysyłkowego klienta umożliwiającego obliczenie kosztów wysyłki i podatku. Zalecamy skorzystać z innych opcji z menu „Opłata za wysyłkę” i „Stawka podatku”.
Czy płatne łącza i przyciski obsługują elementy webhook?
Tak. Oto jak włączyć elementy webhook:
- Zaloguj się do panelu programisty przy użyciu danych logowania do rachunku handlowca.
- Przełącz na usługę Live.
- Kliknij opcję Aplikacje i poświadczenia.
- Przewiń w dół i wybierz opcję Zarządzaj elementami webhook.
- Teraz możesz dodać adres URL elementu webhook dla usługi Live. Jeśli chcesz dodać elementy webhook do usługi Sandbox, pozostań na tej stronie i przełącz się z Live na Sandbox w prawym górnym rogu strony.
- Dodaj adres URL wywołania zwrotnego elementów webhook, wybierz wszystkie zdarzenia lub realizację transakcji, zdarzenia płatności, które będą wywoływane przez system PayPal po wybranych zdarzeniach stosownie do implementacji interfejsu API NVP lub SOAP. Wywołaj interfejs API PayPal NVP/SOAP, aby uzyskać informacje o elemencie webhook.
Przykładowa odpowiedź elementu webhook:
"id": "WH-12D11567VE3425924-2G120938U32719946",
"event_version": "1.0",
"create_time": "2024-09-14T15:55:58.043Z",
"resource_type": "capture",
"resource_version": "2.0",
"event_type": "PAYMENT.CAPTURE.COMPLETED",
"summary": "Payment completed for $ 128.88 USD",
"resource": {
"supplementary_data": {
"related_ids": {
"order_id": "8LM68409BR5528307"
}
],
"id": "7KK30254642170736",
"status": "COMPLETED"